home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 November / CHIP Kasım 1998.iso / emulators / nintendo / rnes054dos.exe / readme.txt next >
Text File  |  1998-09-12  |  10KB  |  281 lines
  1.  
  2.                      RockNES 0.54 - September, 12th 1998
  3.                      ===================================
  4.  
  5. -> The RockNES team:
  6.  
  7. Fx3       :  gyfay@convex.com.br
  8. Kritz     :  val@xcelco.on.ca
  9.  
  10. NOTES :
  11. ======
  12.  
  13. 1) When a game seems to be blocked press ENTER key (as START) perhaps that
  14. will start the game, like Bionic Commando;
  15. 2) If you want to join xNes, let me know. Just mail me;
  16. 3) ANY info about AUTOFRAMESKIP and GCC switches to speed up the NES
  17. emulation would be great to us;
  18. 4) Tell me if PGCC really speeds up the emulation;
  19. 5) ANY PROBLEM AND I'LL STOP RockNES.
  20.  
  21. ---------------------------------------------------------------------------
  22.  
  23. #include <st_credit.h>
  24.  
  25. -> RockNES. Copyright (c) 1997,1998 Gyfay Software.
  26. -> Nintendo is trademark of Nintendo.
  27. -> Neither Gyfay Software nor the author are affiliated with Nintendo
  28.    nor advocate the piracy of Nintendo games.
  29. -> RockNES is freeware. You can to distribute it freely, as long as it is
  30.    non-modified. Commercial ROMs *NEVER* can be packaged with this emu.
  31. -> When you use this software you do so at your own risk. The author is
  32.    not responsible for any loss or damage resulting from the use or misuse
  33.    of this software.
  34.  
  35. -> If you do not agree with these terms delete this software now.
  36.  
  37. Many games don't work correctly (or at all).
  38. Don't mail me case your favorite ROM doesn't work.
  39.  
  40. ---------------------------------------------------------------------------
  41.  
  42. I. Intro
  43. ========
  44.  
  45. -> xNes is/was a NES 8-bit emulator, now it calls RockNES. It was firstly
  46. wrote for DOS, but ported later to Linux and MacOS. Six months after the last
  47. release from Nicolas Hamel, it was resumed by me, Fx3. Only the DOS port will
  48. be updated for now, unless someone wants to port my emulator.
  49.  
  50. -> The compatibility of RockNES grows version after version. The goal of
  51. RockNES is to be a great emu: fast, compatible and FREE.
  52.  
  53. -> It was entirely write in C and compiled with DJGPP/Allegro 3.0.
  54. Versions >0.5x was compiled with PGCC (Pentium version of gcc).
  55.  
  56. II. History :
  57. =============
  58.  
  59. Sorry I don't have the docs of older versions of RockNES :) 
  60. If you'd like to update my compatibility list, go ahead an mail me.
  61.  
  62. Version 0.54
  63.         - Fixed an error in ClearScreen() - now there is no 'Error in ClearScreen()'
  64.         - Fixed sprite priority - sprites can go behind things now 
  65.           (For example, in Zelda when you walk up/down stairs)
  66.         - Fixed mapper #2 bug - Only a few more ROMS work, some still don't
  67.         - Fixed mapper #3 bug - All mapper #3 ROMS should work now
  68.         - Fixed mapper #9 bug - Now, PunchOut looks much better, but no playable yet
  69.         - Fixed a slight problem when you reset some ROMs
  70.         - Changed the palette to the one Nesticle uses because it works/looks better
  71.         - Changed the pallete around so that a border isn't shown around the screen
  72.         - Added support for extended mappers #16+, no mappers implemented yet
  73.         - Added a configuration file
  74.         - Added a little text displayer 
  75.           (it pops up, when you reset, raise/lower the frame rate, etc..)
  76.         - Some small optimizations, barely noticeable
  77.         - Some bugs fixed in the Rd6502/Wr6502 functions
  78.         - Player 2 support w/ redefinable settings for buttons
  79.         - Don't show left 8 pixels of the screen [PPU flag] 
  80.           (Paperboy needed this flag working as well as others)
  81.         - Don't show sprites in left 8 pixels of the screen [PPU flag]
  82.         - An option to specify a ROM directory location in the configuration file 
  83.  
  84.         
  85. Version 0.53 Release 3b :
  86.         - Whops! Fixed a bug in the PPU (just play to see). Now, Ghosts'n
  87. Goblins works fine;
  88.         - While keys '+' or '-' are pressed, the frameskip isn't changed.
  89.           Just press a key one time to increase/decrease. Same to F5 (reset).
  90.  
  91. Version 0.53 Release 3 :
  92.         - Some changes in the sprite/BGM code;
  93.         - The screen is correctly centered;
  94.         - Maybe more games are working (like Power Blade 2) or with
  95.           a bit less glitches (like Tetris from Tengen).
  96.  
  97. Version 0.53 Release 2 :
  98.         - Fixed a bug in the sprite code (sorry);
  99.         - Some changes when writting to the PPU;
  100.         - Some little changes in the main code.
  101.  
  102. Version 0.53 :
  103.         - Removed tons of unused variables;
  104.         - Big clean of source code;
  105.         - Fixed a bug in the PPU (background color, now Rockman 1 is okay);
  106.         - Frameskip range set to 0-6 (default=2);
  107.         - Fixed some bugs in the 6502 functions (Rd/Wr/loop);
  108.         - Fixed a bug in the Mapper 7 (incorrect name table);
  109.         - Fixed a bug in the Reset_Nes();
  110.         - Fixed the shutdown function (TrashMachine);
  111.         - Fixed a bit the current graphic engine;
  112.         - Screen is always centered in any video mode;
  113.         - You can hide the .NES extension (ex: RockNES gamename OR gamename.NES);
  114.         - 5-15% more faster (really?).
  115.  
  116. Version 0.52 :
  117.         - Compiled with PGCC (for Pentium processors);
  118.         - Fixed bugs parsing command line switches;
  119.         - More video resolutions, with all modes merged to -gfx switch.
  120.  
  121. Version 0.51 :
  122.         - Encapsulated xnes.dat (palette);
  123.         - Added joystick support (4-buttons, player 1 only);
  124.         - The emulator doesn't crash more when unable to initialise graphics modes;
  125.         - Primitive GUI removed to be improved;
  126.         - New resolutions, with auto detection improved (a bit faster);
  127.         - Some changes in the messages.
  128. ----------------------------------------------------------------------------------------
  129. Version 0.45 :
  130.         - Speed up into the 6502 emulation core of Marat
  131.         - fixed bug into the PPU memory
  132.         - MMC 4 partially supported ( Mario2 is playable )
  133.  
  134. Version 0.40 :
  135.         - Very more compatible !
  136.         - ModeX added
  137.         - 8x16 Sprite fixed
  138.         - Some fix in the xNes code
  139.         - Big fix in the MMC 1
  140.         - Sprite Priority
  141.         - Some fix in the MMC 9
  142.         - Some stupid bug in the xNes code removed
  143.         - New Graphic engine reworked
  144.  
  145. Version 0.30 :
  146.         - Better Graphics
  147.         - New graphic engine
  148.         - MMC 9 added / VERY BUGGY !
  149.         - MMC 1 fixed
  150.         - Fixed the 6502
  151.         - other things that I dont remember.
  152.  
  153. III. What RockNES does :
  154. =====================
  155.  
  156. Currently:
  157.  
  158. - The 6502, provided by Marat;
  159. - Sprites 8x8 and 8x16;
  160. - Trainer;
  161. - IO Ports;
  162. - Sprite flipping & mirroring;
  163. - Fake color palette (not from a real NES);
  164. - Scrollings;
  165. - Backed Battery;
  166. - Configuration File;
  167. - FULL MAPPERS....: 0 and 3;
  168. - PARTIAL MAPPERS.: 1,2,4,7,9,10 and 11.
  169.  
  170. In the future:
  171.  
  172. - Full GUI;
  173. - Full sound;
  174. - Lightgun support (with mouse?);
  175. - 6502 in ASM (not in C);
  176. - Real time save/load games (I must to adjust it for each loaded mapper);
  177. - Faster graphics engine (scanline based, not Name Table based);
  178. - Mappers working in full other than #0 and #3;
  179. - Addition of all mappers possible.
  180.  
  181. The major speed bottleneck right now is the graphics engine it's rendering
  182. unnecesary information. It's going to have to be rewritten from scratch.
  183. This will also allow to write it as a scanline engine and not as a tile
  184. engine, which is requiered because that's the way the real NES works.
  185.  
  186. IV. Contents from this ZIP file:
  187. ================================
  188.  
  189. readme.txt  => This file.
  190. RockNES.exe => The executable.
  191.                                       
  192. => NEVER ask me about commercial ROMs. I cannot provide them, so don't ask me
  193. how to find/dump, please!
  194.  
  195. V. Hardware required :
  196. ======================
  197.  
  198. - Intel Pentium 166Mhz processor or higher;
  199. - MS-DOS 6.xx (Win9x recommended);
  200. - 8 MB of memory. I didn't tried it on 4 mb so...
  201. - VESA support (get Display Doctor from www.scitechsoft.com).
  202.  
  203. I don't know the minimum... maybe:
  204.  
  205. - 486 66Mhz, 8Mb RAM;
  206. - MS-DOS 6.xx (maybe 5.xx);
  207. - Color graphic card.
  208.  
  209. => RockNES uses (by default) a VGA mode 320x200 to be more compatible with
  210. all videocards/monitors, but it's clipped. You can use a standard VGA
  211. graphics, ModeX, VESA or AUTODETECT. The best resolution is 320x240 VBE2
  212. Linear (use -videocard 5 ). RockNES can autodetect your videoboard case
  213. you've any problem. VESA is faster than others video modes.
  214.  
  215. => The RockNES >0.50 was (and'll be) compiled with PGCC (GCC Pentium version)
  216. to increase speed. At moment, I don't notice speed increase, but, it's okay.
  217.  
  218. VI. To use it :
  219. ===============
  220.  
  221. [USE RockNES AT YOUR OWN RISK !!]
  222.  
  223. Syntax: rocknes <filename> -op1 -op2 ... -op80:
  224.  
  225.          -f x   : Sets frame rate to x (default: 2).
  226.          -b x   : Forces the use of x as battery file.
  227.  
  228.          -p1 x  : Forces input1: 1-KEYBOARD1, 2-JOYSTICK1, 3-GAMEPAD.
  229.          -p2 x  : Forces input2: 1-KEYBOARD2, 2-JOYSTICK2, 3-GAMEPAD.
  230.          -gfx x : Forces a video resolution, x can be:
  231.  
  232.          * 0-6 320x240 modes *      * AUTO modes *
  233.            0 - AUTODETECT            7 - 400x300 
  234.            1 - VGA Mode 13h          8 - 512x384 
  235.            2 - Mode-X                9 - 640x480 
  236.            3 - VESA 1.x                   ..     
  237.            4 - VESA 2.0 BANKED            ..     
  238.            5 - VESA 2.0 LINEAR            ..     
  239.            6 - VBE/AF                     ..     
  240.  
  241. During the execution:
  242.  
  243. ESC to quit and back to command line;
  244. F12 to do a screenshot to xNES.pcx (temporarily disbaled);
  245. F5  to reset the virtual NES;
  246. '+' to increase Frame Rate (max=6);
  247. '-' to decrease Frame Rate (min=0).
  248. (while you keep a key pressed, the emulator will stay paused)
  249.  
  250. VII. ROM file format supported :
  251. ================================
  252.  
  253. => RockNES supports only the iNES file format!
  254. To make sure, check the .NES extension.
  255.  
  256. VIII. Greetings :
  257. =================
  258.  
  259. - Marat for his 6502 emulator (m6502.c);
  260. - All the person behind DJGPP;
  261. - Shawn for Allegro 3.0;
  262. - Y0SHI for his nestech.txt;
  263. - Loopy for his palette and help;
  264. - LoneWolf of Dragones, for his help with MMC 1 and 8x16 sprite.
  265.  
  266. Special thanks :
  267.  
  268. - Brad Oliver for his help;
  269. - Nicolas Hamel and David M. by the original source;
  270. - Roberto Rosario for his help;
  271. - All the old (and new) xNes (RockNES) team!!!
  272.  
  273. IX. Contacts :
  274. ==============
  275. http://www.geocities.com/TimesSquare/Castle/2622/xnes.html
  276.  
  277. ////////////////////////////////////////////////////////////////////////////
  278. If you disagree, delete this software now.
  279.  
  280.                                 eof
  281.